home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 5 / Gold Medal Software - Volume 5 (Gold Medal) (1995).iso / music / d10sound.arj / QS-TUTOR.DOC < prev    next >
Text File  |  1994-04-04  |  6KB  |  254 lines
  1.  
  2.  
  3.                 -1-
  4.  
  5.  
  6.             'Quick Send v2.0'
  7.  
  8.     Midi System Exclusive Librarian Utility Tutorial
  9.  
  10.  
  11. This document is an attempted short tutorial on the use of QS.EXE v2.0.
  12. This IS NOT a MIDI tutorial. I will take under consideration that you
  13. already have read the MIDI 1.0 specification chart, or at least know
  14. the basics of MIDI system exclusive messages.
  15.  
  16. Important "key words" and "phrases" are typed in UPPER CASE.
  17.  
  18. The program is based upon the MIDI SYSTEM EXCLUSIVE function, and
  19. a "home grown" LIBRARIAN SYSTEM. Where PATCH DATA, etc. Is stored
  20. in STANDARD MIDI v1.0 HEX FORMAT FILES on DOS DISK. The DOS DISK
  21. may be FLOPPY DISKETTE or HARD DRIVE.
  22.  
  23.  
  24. Cont. pg. 2
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                 -2-
  71.  
  72. There are TWO MODES in which the program operates:
  73.  
  74.     1) INTERACTIVE MODE
  75.  
  76.        This mode can be used for all methods of SYSEX supported by
  77.        QS v2.0. It simply means that you will be prompted by the program
  78.        for various input.
  79.  
  80.     2) NON-INTERACTIVE MODE
  81.  
  82.        This mode is for SENDING DATA only. The DOS COMMAND LINE is
  83.        used to contain the FILENAME that you will be sending to your
  84.        MIDI UNIT. Only 1 FILENAME is supported by QS v2.0. The file
  85.        will be sent out the MPU-401 DATA PORT.
  86.  
  87.        To use this mode, type 'QS <filename>' at the DOS PROMPT and
  88.        press <ENTER>.
  89.        Where:
  90.              '<filename>' = The file containing MIDI SYSEX PATCH DATA.
  91.  
  92.        This file should be STANDARD MIDI 1.0 SYSEX FORMAT DATA.
  93.        Refer to your MIDI UNIT'S IMPLEMENTATION CHART for proper
  94.        SYSEX COMMAND FORMATS.
  95.  
  96. Cont. pg. 3
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                 -3-
  137.  
  138. There are THREE SYSEX METHODS which are used in QS v2.0:
  139.  
  140.     1) SEND PROMPT DATA/RECEIVE DATA
  141.  
  142.            This method is REFERRED TO AS 'Send/Receive'. It should be
  143.        popular with MT-32 users who have to resort to this method due
  144.        to the fact that this is the only method supported by the MT-32
  145.        for RECEIVING PATCH DUMPS from the MT-32.
  146.  
  147.        This method is only available through INTERACTIVE MODE.
  148.  
  149. STEP 1:       To use this method choose [S] from the opening 'Command?' prompt.
  150.  
  151. STEP 2:       The program will then prompt for the name of the file to send.
  152.        This should be a BINARY HEX FILE which contains a MIDI EXCLUSIVE
  153.        MESSAGE. For example: If I want to REQUEST PATCH DATA from my
  154.        MT-32 I would need to send these bytes to the MT-32:
  155.               'F0-41-10-16-11-dd-dd-dd-dd-dd-dd-cs-F7'
  156.        Where: 'dd' = request dump format data.
  157.                   'cs' = checksum calculation.
  158.            If you looked at the first five bytes of this file with a HEX VIEW
  159.        UTILITY, you would see 'F0 41 10 16 11' or 'F041101611' depend-
  160.        ing upon which utility you use to view the file.
  161.  
  162. STEP 3:    a. The program must next know if the file to send will REQUEST
  163.        DATA from the remote unit. If not, hit <ENTER> to skip on to
  164.        STEP 4.
  165.     b. You will next be asked what FILENAME to assign the file which
  166.        will contain the DATA RECEIVED FROM THE MPU-401 DATA PORT.
  167.     c. If the FILENAME you assign already exists, you will be asked if
  168.        it is O.K. TO OVERWRITE THE EXISTING FILE.
  169.  
  170. STEP 4:    a. The program requests memory segments from your computer.
  171.        If successful, the amount of memory allocated for MIDI DATA
  172.        BUFFER will be displayed.
  173.     b. This is where you should determine if the data you are requesting
  174.        will EXCEDE THE BUFFER LIMIT. In most cases you should be safe,
  175.        except in some cases where SAMPLING DATA is requested.
  176.        These patches are known to be up to 256K or even more. If the data
  177.        does EXCEDE THE LIMIT, you will not get a complete file.
  178.  
  179. STEP 5:       QS v2.0 now prompts you to PRESS ANY KEY TO '[TASK]' or
  180.        hit [ESC] to EXIT.
  181.          Where: '[TASK]' = One the "referred to as" METHODS.
  182.  
  183. STEP 6:       The program reads the data from the FILENAME TO SEND and sends
  184.        each byte OUT THE MPU-401 DATA PORT as it is read from disk.
  185.  
  186. STEP 7:       THE PROGRAM WILL NOW WAIT 120 SECONDS BEFORE RETRIEVING DATA
  187.        RECEIVED FROM THE MIDI DATA BUFFER.
  188.  
  189. STEP 8:    a. You may PRESS ANY KEY TO BEGIN RETRIEVING DATA... or,
  190.        WAIT for the 120 SECOND WAIT PERIOD TO EXPIRE, where QS v2.0
  191.        will RETRIEVE THE DATA REGARDLESS OF MIDI STATUS.
  192.     b. If you feel that the MIDI UNIT is DONE SENDING DATA, you may
  193.        PRESS ANY KEY to begin STEP 9.
  194.  
  195. Cont. pg. 4
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.                 -4-
  208.  
  209. STEP 9:    a. The amount of BYTES RECEIVED will be displayed on screen.
  210.        You will be asked if MIDI DATA TRANSMISSION WAS O.K.
  211.        In other words, IS IT O.K. to WRITE DATA IN BUFFER TO FILE?
  212.     b. If for any reason you think that ALL DATA WAS NOT RECEIVED,
  213.        you may relpy "n" for NO, (DO NOT WRITE FILE) or, just hit
  214.        enter for a 'NO' REPLY and skip to STEP 10.
  215.        CAUTION! IF YOU DO NOT REPLY 'y' or 'YES' TO THIS PROMPT,
  216.        ALL MIDI DATA IN MEMORY RECEIVED FROM MPU-401 DATA PORT
  217.        WILL BE LOST.
  218.     c. Program begins to RETREIVE DATA IN MEMORY FROM MIDI DATA BUFFER
  219.        and WRITES EACH BYTE TO FILE AS IT IS RETREIVED.
  220.  
  221. STEP 10:   The program will ask if you want it to REPEAT, or EXIT TO DOS.
  222.  
  223.  
  224.  
  225.     2) SEND DATA
  226.  
  227.        This method is REFERRED TO AS 'Send'. It should be supported by
  228.        ALL MIDI UNITS. It will allow you to send SYSEX PATCH FILES to a
  229.        MIDI UNIT. There is NO LIMIT ON THE SIZE OF THE FILE TO SEND.
  230.  
  231.        This method is available through INTERACTIVE MODE, or
  232.        NON-INTERACTIVE MODE (command line).
  233.  
  234.        To use this method in INTERACTIVE MODE, 
  235.        choose [S] from the opening 'Command?' prompt.
  236.  
  237.        REFER TO STEPS 1 THRU 2, 6 and 10 in SEND/RECEIVE MODE.
  238.  
  239.  
  240.  
  241.     3) RECEIVE DATA
  242.  
  243.        This method is REFERRED TO AS 'Receive' or 'PANEL DUMP'.
  244.        It should be supported by most SYNTHESIZERS.
  245.  
  246.        To use this method choose [R] from the opening 'Command?' prompt.
  247.  
  248.        REFER TO STEPS 3 THRU 5 and 7 THRU 10 in SEND/RECEIVE MODE.
  249.  
  250. End.
  251.  
  252.  
  253.  
  254.